5.1.1 创建提款数字币至任意钱包
#简要描述： 将数字币提现到钱包的提现业务接口，让用户能够将 usdt 转移到指定的钱包地址
- 请求方式: POST
- 请求接口: https://网关域名/wallet-trade-merchant/v1/pay/blockchain/create
- 请求媒体类型( JSON 数据格式 )Content-Type: application/json
请求参数
| 参数名称 | 类型 | 必填 | 参数含义 | 参数说明 |
|---|---|---|---|---|
| key | string | 是 | 商户 key | 平台分配商户 key |
| localOrderId | string | 是 | 商户平台本地订单号 | 商户平台本地生成唯一订单号 |
| localUserId | string | 否 | 商户平台本地用户ID | 商户平台本地用户ID |
| amount | number | 是 | 订单金额 | 提款金额 |
| network | string | 是 | 主网 | 主网(目前仅支持 TRON、BSC、POLYGON、ETHEREUM) |
| address | string | 是 | 提款地址 | 提款地址 |
| notifyUrl | string | 否 | 回调地址 | 下单成功后，由 API 回调通知商户的地址 | (回调详情参照文档3) |
| currency | string | 是 | 币种 | 币种(钱包支持数字币种) |
| successRedirectUrl | string | 否 | 地址 | 成功后自动跳转地址 |
| isBlockchain | boolean | 否 | 是否返回区块链信息（默认false） | 当为true时，回调请求会携带订单链上交易信息 |
| sign | string | 是 | 签名 | 详情见签名算法 |
请求 json 样例
{
"key": "weOfDMRpUAvAeOs5",
"localOrderId": "tencenaa11124",
"localUserId": "123",
"notifyUrl": "http://www.baidu.com",
"amount": 20.11,
"network": "TRON",
"currency": "USDT",
"successRedirectUrl": "http://www.baidu.com",
"address": "TJHr9DVyik4R1JGPYngNeS8Qy4iD2qpqB6",
"sign": "41c48ea2951934626b4435f02aecf732"
}
支付返回 json 格式
返回 data 示例
{
"code": 0,
"success": true,
"message": "string",
"data": {
"orderId": 243055699879743,
"localUserId": "123",
"localOrderId": "tencenaa11124",
"orderType": "PAYMENT",
"orderBizType": "WITHDRAW_ANY_DIGITAL_WALLET"
}
}
data 参数说明
| 参数名称 | 类型 | 必填 | 参数含义 | 备注 |
|---|---|---|---|---|
| orderId | string | 是 | 订单 ID | |
| localUserId | string | 是 | 商户本地用户 ID | |
| localOrderId | string | 是 | 商户本地订单号 | |
| orderType | enum | 是 | 订单类型 | PAYMENT：支付订单 WITHDRAW：提款订单 |
| orderBizType | enum | 是 | 订单业务类型 | orderBizType 类型说明如下 |
| targetType | enum | 是 | 目标类型 | targetType 类型说明如下 |
| network | string | 是 | 主网类型 | |
| address | string | 是 | 地址 |
orderBizType 类型说明：
1、PAYMENT_WALLET_SCAN MINPAY钱包扫码支付
2、PAYMENT_TRANSFER 数字币绑定地址直充
3、PAYMENT_ANY_DIGITAL_SCAN 数字币任意金额扫码支付
4、WITHDRAW_WALLET 提款至MINPAY钱包
5、WITHDRAW_ANY_DIGITAL_WALLET 提款数字币至任意钱包
6、PAYMENT_FIXED_DIGITAL_SCAN 数字币限定金额扫码支付
7、BATCH_PAY 批量代付
targetType 类型说明：
1、INTERNAL 内部地址
2、EXTERNAL 外部地址
3、USER 用户抽象地址
回调返回 json 数据
回调 data
{
"amount": 11,
"bizType": "WITHDRAW_ANY_DIGITAL_WALLET",
"blockchain":{
"network":"TRON",
"receiverAddress":"TA1jptT16DssYWVGdVyFWxonku6hWK7En3",
"senderAddress":"TPutFhYUQnrRxHSmKVwjp55vgk9QY6r5nS",
"txId":"24d0d0e5d417bd2195c45d64724760ae47fc3b359ee31c5fedf25b40f3584b36"
},
"currency": "CNY",
"key": "h3cS7dBltRU4W1wD",
"localOrderId": "2820",
"merchantActualAmount": 8.86,
"merchantCurrency": "CNY",
"merchantId": 303122065665,
"merchantPaidAmount": 10.98,
"merchantUserId": "97",
"notifyTime": 1731572168370,
"orderCreateTime": 1731572133082,
"orderId": "273124814912907",
"sign": "699806308a9e055114c378671b0d2a15",
"status": "SUCCESS",
"type": "PAYMENT",
"userAmount": 1.55,
"userCurrency": "USDT"
}